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Status of this Memo 
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improvements. Please refer to the current edition of the "Internet 
Official Protocol Standards" (STD 1) for the standardization state 
and status of this protocol. Distribution of this memo is unlimited. 
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Abstract 


This document describes an Extensible Provisioning Protocol (EPP) 
mapping for the provisioning and management of individual or 
organizational social information identifiers (known as "contacts") 
stored in a shared central repository. Specified in Extensible 
Markup Language (XML), the mapping defines EPP command syntax and 
semantics as applied to contacts. 


Table of Contents 


T Introduction 5 
1.1. Conventions Used In This Document, 
2. Object Attributes. 
2.1. Contact and Client identifiers 
2.2. Status Values. š 
2.3. Individual and Örganizationāl Names. 
2.4. Address. ER fe, ENE RD AE Bree UE See, of! 
2.4.1. Street, City, and State or Province. 


2.4.2. Postal Code. 
2.4.3. Country. 
5 Telephone Numbers. 
6 Email Addresses. 
7. Dates and Times. X 
.8. Authorization Information. 
9. Disclosure of Data Elements and “Attributes 
P Command mapping. 
1 EPP Query Commands 
3.1.1. EPP <check> Commañä. 


WHNNNN NWN 
WDDAAADAARUNUNUUNUUWWWDN DY 


Hollenbeck Standards Track [Page 1] 


RFC 3733 EPP Contact Mapping 


Wood UE 


EPP <info> Command 

EPP <transfer> Query Command 
raneto Commands 

EPP <create> Command 

EPP <delete> Command 

EPP <renew> Command 

EPP <transfer> Command. 

EPP <update> Command. 


hj 


sive 
1% 
P 
2 
DAR 
2 
2 
2 


EO Or TE ELO) 
SununHHum 


32 
Formal Syntax. . 
Taternatlonalization Considetations 
IANA Considerations. 

Security Considerations. 
Acknowledgements 

References Dr 

9.1. Normative Referencës 

9.2. Informative References 
Author’s Address 

Full Copyright Statement 


1. Introduction 


Offline Review of Requested Actions. 


March 2004 


10 
14 
16 
17 
20 
21 
21 
23 
26 
29 
37 
38 
38 
38 
39 
39 
39 
40 
41 


This document describes a personal and organizational identifier 
mapping for version 1.0 of the Extensible Provisioning Protocol 


(EPP). 


This mapping is specified using the Extensible Markup 


Language (XML) 1.0 as described in [XML] and XML Schema notation as 
described in [XMLS-1] and [XMLS-2]. 


[RFC3730] provides a complete description of EPP command and response 


structures. 


A thorough understanding of the base protocol 


specification is necessary to understand the mapping described in 
this document. 


XML is case sensitive. Unless stated otherwise, XML specifications 
and examples provided in this document MUST be interpreted in the 
character case presented to develop a conforming implementation. 


Leds 


The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", 


Conventions Used In This Document 


"SHALL NOT", 


"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this 


document are to be interpreted as described in [RFC2119]. 


In 


represents lines returned by a protocol server. 


examples, "C:" represents lines sent by a protocol client and "S:" 


Indentation and 


white space in examples is provided only to illustrate element 
relationships and is not a REQUIRED feature of this protocol. 
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2. Object Attributes 


An EPP contact object has attributes and associated values that can 
be viewed and modified by the sponsoring client or the server. This 
section describes each attribute type in detail. The formal syntax 
for the attribute values described here can be found in the "Formal 
Syntax" section of this document and in the appropriate normative 
references. 


2.1. Contact and Client Identifiers 


All EPP contacts are identified by a server-unique identifier. 
Contact identifiers are character strings with a specified minimum 


length, a specified maximum length, and a specified format. Contact 
identifiers use the "clIDType" client identifier syntax described in 
[RFC3730]. 


2.2. Status Values 


A contact object MUST always have at least one associated status 
value. Status values can be set only by the client that sponsors a 
contact object and by the server on which the object resides. A 
client can change the status of a contact object using the EPP 
<update> command. Each status value MAY be accompanied by a string 
of human-readable text that describes the rationale for the status 
applied to the object. 


A client MUST NOT alter status values set by the server. A server 
MAY alter or override status values set by a client subject to local 
server policies. The status of an object MAY change as a result of 
either a client-initiated transform command or an action performed by 
a server operator. 

Status values that can be added or removed by a client are prefixed 
with "client". Corresponding status values that can be added or 
removed by a server are prefixed with "Server". Status values that 
do not begin with either "client" or "server" are server-managed. 
Status Value Descriptions: 

- clientDeleteProhibited, serverDeleteProhibited 

Requests to delete the object MUST be rejected. 


— clientTransferProhibited, serverTransferProhibited 


Requests to transfer the object MUST be rejected. 
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- clientUpdateProhibited, serverUpdateProhibited 


Requests to update the object (other than to remove this status) MUST 
be rejected. 


- linked 


The contact object has at least one active association with another 
object, such as a domain object. Servers SHOULD provide services to 
determine existing object associations. 


- ok 


This is the normal status value for an object that has no pending 
operations or prohibitions. This value is set and removed by the 
server as other status values are added or removed. 


— pendingCreate, pendingDelete, pendingTransfer, pendingUpdate 


A transform command has been processed for the object, but the action 
has not been completed by the server. Server operators can delay 
action completion for a variety of reasons, such as to allow for 
human review or third-party action. A transform command that is 
processed, but whose requested action is pending, is noted with 
response code 1001. 


With one exception, transform commands MUST be rejected when a 
pendingCreate, pendingDelete, pendingTransfer, or pendingUpdate 
status is set. The only exception is that a <transfer> command to 
approve, reject, or cancel a transfer MAY be processed while an 
object is in "pendingTransfer" status. 


When the requested action has been completed, the pendingCreate, 
pendingDelete, pendingTransfer, or pendingUpdate status value MUST be 
removed. All clients involved in the transaction MUST be notified 
using a service message that the action has been completed and that 
the status of the object has changed. 


"ok" status MAY only be combined with "linked" status. 
"linked" status MAY be combined with any status. 


"pendingDelete" status MUST NOT be combined with either 
"clientDeleteProhibited" or "serverDeleteProhibited" status. 


"pendingTransfer" status MUST NOT be combined with either 
"clientTransferProhibited" or "serverTransferProhibited" status. 
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"pendingUpdate" status MUST NOT be combined with either 
"clientUpdateProhibited" or "serverUpdateProhibited" status. 


The pendingCreate, pendingDelete, pendingTransfer, and pendingUpdate 
status values MUST NOT be combined with each other. 


Other status combinations not expressly prohibited MAY be used. 
2.3. Individual and Organizational Names 


Individual and organizational names associated with a contact are 
represented using character strings. These strings have a specified 
minimum length and a specified maximum length. Individual and 
organizational names MAY be provided in both UTF-8 [RFC2279] anda 
subset of UTF-8 that can be represented in 7-bit ASCII depending on 
local needs. 


2.4. Address 


Every contact has associated postal address information. A postal 
address contains OPTIONAL street information, city information, 
OPTIONAL state/province information, an OPTIONAL postal code, anda 
country identifier. Address information MAY be provided in both 
UTF-8 and a subset of UTF-8 that can be represented in 7-bit ASCII 
depending on local needs. 


2.4.1. Street, City, and State or Province 
Contact street, city, and state or province information is 
represented using character strings. These strings have a specified 


minimum length and a specified maximum length. 


2.4.2. Postal Code 


Contact postal codes are represented using character strings. These 
strings have a specified minimum length and a specified maximum 
length. 


2.4.3. Country 


Contact country identifiers are represented using two-character 
identifiers specified in [ISO3166]. 


2.5. Telephone Numbers 
Contact telephone number structure is derived from structures defined 


in [E164a]. Telephone numbers described in this mapping are 
character strings that MUST begin with a plus sign ("+", ASCII value 
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0x002B), followed by a country code defined in [E164b], followed by a 
dot (".", ASCII value 0x002E), followed by a sequence of digits 
representing the telephone number. An optional "x" attribute is 
provided to note telephone extension information. 


2.6. Email Addresses 


Email address syntax is defined in [RFC2822]. This mapping does not 
prescribe minimum or maximum lengths for character strings used to 
represent email addresses. 


2.7. Dates and Times 


Date and time attribute values MUST be represented in Universal 
Coordinated Time (UTC) using the Gregorian calendar. The extended 
date-time form using upper case "T" and "Z" characters defined in 
[RFC3339] MUST be used to represent date-time values as XML Schema 
does not support truncated date-time forms or lower case "T" and "Z" 
characters. 


2.8. Authorization Information 


Authorization information is associated with contact objects to 


facilitate transfer operations. Authorization information is 
assigned when a contact object is created, and it might be updated in 
the future. This specification describes password-based 


authorization information, though other mechanisms are possible. 
2.9. Disclosure of Data Elements and Attributes 


The EPP core protocol requires a server operator to announce data 
collection policies to clients; see section 2.4 of [RFC3730]. In 
conjunction with this disclosure requirement, this mapping includes 
data elements that allow a client to identify elements that require 
exceptional server operator handling to allow or restrict disclosure 
to third parties. 


A server operator announces a default disclosure policy when 
establishing a session with a client. When an object is created or 
updated, the client can specify contact attributes that require 
exceptional disclosure handling using an OPTIONAL <contact:disclose> 
element. Once set, disclosure preferences can be reviewed using a 
contact information query. A server operator MUST reject any 
transaction that requests disclosure practices that do not conform to 
the announced data collection policy with a 2308 error response code. 
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If present, the <contact:disclose> element MUST contain a "flag" 
attribute. The "flag" attribute contains an XML Schema boolean 
value. A value of "true" or "1" (decimal one) notes a client 
preference to allow disclosure of the specified elements as an 
exception to the stated data collection policy. A value of "false" 
or "0" (decimal zero) notes a client preference to not allow 
disclosure of the specified elements as an exception to the stated 
data collection policy. 


The <contact:disclose> element MUST contain at least one of the 
following child elements: 


<contact:name type="int"> 
<contact:name type="loc"> 
<contact:org type="int"> 
<contact:org type="loc"> 
<contact:addr type="int"> 
<contact:addr type="loc"> 
<contact:voice> 
<contact:fax> 
<contact:email> 


Example <contact:disclose> element, flag="0": 


<contact:disclose flag="0"> 
<contact :email> 
<contact :voice> 
</contact:disclose> 


In this example, the contact email address and voice telephone number 
can not be disclosed. All other elements are subject to disclosure 
in accordance with the server’s data collection policy. 


Example <contact:disclose> element, flag="1": 


<contact:disclose flag="1"> 
<contact:name type="int"> 
<contact:org type="int"> 
<contact:addr type="int"> 

</contact:disclose> 


In this example, the internationalized contact name, organization, 
and address information can be disclosed. All other elements are 
subject to disclosure in accordance with the server’s data collection 
policy. 
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Client identification features provided by the EPP <login> command 
and contact authorization information are used to determine if a 
client is authorized to perform contact information query commands. 
These features also determine if a client is authorized to receive 
data that is otherwise marked for non-disclosure in a query response. 


3. EPP Command mapping 
A detailed description of the EPP syntax and semantics can be found 


in [RFC3730]. The command mappings described here are specifically 
for use in provisioning and managing contact objects via EPP. 


3.1. EPP Query Commands 


EPP provides three commands to retrieve contact information: <check> 
to determine if a contact object can be provisioned within a 
repository, <info> to retrieve detailed information associated with a 
contact object, and <transfer> to retrieve contact object transfer 
status information. 


3.1.1. EPP <check> Command 


The EPP <check> command is used to determine if an object can be 
provisioned within a repository. It provides a hint that allows a 
client to anticipate the success or failure of provisioning an object 
using the <create> command as object provisioning requirements are 
ultimately a matter of server policy. 


In addition to the standard EPP command elements, the <check> command 
MUST contain a <contact:check> element that identifies the contact 
namespace and the location of the contact schema. The 
<contact:check> element contains the following child elements: 


— One or more <contact:id> elements that contain the server-unique 
identifier of the contact objects to be queried. 


Example <check> command: 


C:<?xml version="1.0" encoding="UTF-8" standalone="no"?> 
C:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0" 


Ce xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 

Gs xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 

Gs epp-1.0.xsd"> 

C: <command> 

Cs <check> 

C: <contact: check 

Cs xmlns:contact="urn:ietf:params:xml:ns:contact-1.0" 

Ce xsi:schemaLocation="urn:ietf:params:xml:ns:contact-1.0 
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contact-1.0.xsd"> 
<contact:id>sh8013</contact:id> 
<contact:id>sah8013</contact:id> 
<contact:id>8013sah</contact:id> 
</contact:check> 
</check> 
<c1TRID>ABC-12345</c1TRID> 
</command> 
:</epp> 


ALO. OG ACOs: OQ 


When a <check> command has been processed successfully, the EPP 
<resData> element MUST contain a child <contact:chkData> element that 
identifies the contact namespace and the location of the contact 
schema. The <contact:chkData> element contains one or more 
<contact:cd> elements that contain the following child elements: 


- A <contact:id> element that identifies the queried object. This 
element MUST contain an "avail" attribute whose value indicates 
object availability (can it be provisioned or not) at the moment 
the <check> command was completed. A value of "1" or "true" means 
that the object can be provisioned. A value of "0" or "false" 
means that the object can not be provisioned. 


— An OPTIONAL <contact:reason> element that MAY be provided when an 
object can not be provisioned. If present, this element contains 
server-specific text to help explain why the object can not be 
provisioned. This text MUST be represented in the response 
language previously negotiated with the client; an OPTIONAL "lang" 
attribute MAY be present to identify the language if the 
negotiated value is something other than the default value of "en" 
(English). 


Example <check> response: 


<contact:chkData 
xmlns:contact="urn:ietf:params:xml:ns:contact-1.0" 
xsi:schemaLocation="urn:ietf:params:xml:ns:contact-1.0 
contact-1.0.xsd"> 


S:<?xml version="1.0" encoding="UTF-8" standalone="no"?> 
S:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0" 

Ss xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
S: xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 
Ss epp-1.0.xsd"> 

S: <response> 

S: <result code="1000"> 

S: <msg>Command completed successfully</msg> 

S: </result> 

S: <resData> 

S: 

S: 

S: 

S: 
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<contact:cd> 
<contact:id avail="1">sh8013</contact:id> 
</contact:cd> 
<contact:cd> 
<contact:id avail="0">sah8013</contact :id> 
<contact:reason>In use</contact:reason> 
</contact:cd> 
<contact:cd> 
<contact:id avail="1">8013sah</contact :id> 
</contact:cd> 
</contact:chkData> 
</resData> 
<trID> 
<c1lTRID>ABC-12345</c1TRID> 
<svTRID>54322-XYZ</svTRID> 
</trID> 
</response> 
:</epp> 


ANNNNNNNNNNNNNNNNMN 


An EPP error response MUST be returned if a <check> command can not 
be processed for any reason. 


3.1.2. EPP <info> Command 


The EPP <info> command is used to retrieve information associated 
with a contact object. In addition to the standard EPP command 
elements, the <info> command MUST contain a <contact:info> element 
that identifies the contact namespace and the location of the contact 
schema. The <contact:info> element contains the following child 
elements: 


- A <contact:id> element that contains the server-unique identifier 
of the contact object to be queried. 


— An OPTIONAL <contact:authInfo> element that contains authorization 
information associated with the contact object. If this element 
is not provided or if the authorization information is invalid, 
server policy determines if the command is rejected or if response 
information will be returned to the client. 


Example <info> command: 


C:<?xml version="1.0" encoding="UTF-8" standalone="no"?> 
C:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0" 


Ce xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
G: xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 

Gs epp-1.0.xsd"> 

C <command> 
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On. CHO: DLO OG OOO: Oa 


<info> 
<contact:info 
xmlns:contact="urn:ietf:params:xmlins:contact-1.0" 
xsi:schemaLocation="urn:ietf:params:xml:ins:contact-1.0 
contact-1.0.xsd"> 
<contact :id>sh8013</contact:id> 
<contact :authInfo> 
<contact :pw>2fooBAR</contact : pw> 
</contact:authInfo> 
</contact:info> 
</info> 
<c1TRID>ABC-12345</c1TRID> 
</command> 


:</epp> 


When an <info> command has been processed successfully, the EPP 
<resData> element MUST contain a child <contact:infData> element that 
identifies the contact namespace and the location of the contact 
schema. The <contact:infData> element contains the following child 
elements: 


A <contact:id> element that contains the server-unique identifier 
of the contact object. 


A <contact:roid> element that contains the Repository Object 
IDentifier assigned to the contact object when the object was 
created. 


One or more <contact:status> elements that describe the status of 
the contact object. 


One or two <contact:postallnfo> elements that contain postal 
address information. Two elements are provided so that address 
information can be provided in both internationalized and 
localized forms; a "type" attribute is used to identify the two 
forms. If an internationalized form (type="int") is provided, 
element content MUST be represented in a subset of UTF-8 that can 
be represented in the 7-bit US-ASCII character set. If a 
localized form (type="loc") is provided, element content MAY be 
represented in unrestricted UTF-8. The <contact:postallnfo> 
element contains the following child elements: 


- A <contact:name> element that contains the name of the 
individual or role represented by the contact. 


— An OPTIONAL <contact:org> element that contains the name of the 
organization with which the contact is affiliated. 
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- A <contact:addr> element that contains address information 
associated with the contact. A <contact:addr> element contains 
the following child elements: 


— One, two, or three OPTIONAL <contact:street> elements that 
contain the contact’s street address. 


— A <contact:city> element that contains the contact’s city. 


— An OPTIONAL <contact:sp> element that contains the contact’s 
state or province. 


— An OPTIONAL <contact:pc> element that contains the contact’s 
postal code. 


- A <contact:cc> element that contains the contact’s country 
code. 


— An OPTIONAL <contact:voice> element that contains the contact’s 
voice telephone number. 


— An OPTIONAL <contact:fax> element that contains the contact’s 
facsimile telephone number. 


— A <contact:email> element that contains the contact’s email 
address. 


— A <contact:clID> element that contains the identifier of the 
sponsoring client. 


- A <contact:crID> element that contains the identifier of the 
client that created the contact object. 


- A <contact:crDate> element that contains the date and time of 
contact object creation. 


— A <contact:upID> element that contains the identifier of the 
client that last updated the contact object. This element MUST 
NOT be present if the contact has never been modified. 


— A <contact:upDate> element that contains the date and time of the 
most recent contact object modification. This element MUST NOT be 
present if the contact object has never been modified. 


- A <contact:trDate> element that contains the date and time of the 


most recent successful contact object transfer. This element MUST 
NOT be provided if the contact object has never been transferred. 
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A <contact:authInfo> element that contains authorization 
information associated with the contact object. This element MUST 
NOT be provided if the querying client is not the current 
sponsoring client. 


An OPTIONAL <contact:disclose> element that identifies elements 
that require exceptional server operator handling to allow or 
restrict disclosure to third parties. See section 2.9. fora 
description of the child elements contained within the 
<contact:disclose> element. 


Example <info> response for an authorized client: 


ANNNNNNNNNNNANNNANANNNNANNNNNNNANNNNNNNN 


:<?xml version="1.0" encoding="UTF-8" standalone="no"?> 
:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0" 


xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 
epp-1.0.xsd"> 
<response> 
<result code="1000"> 
<msg>Command completed successfully</msg> 
</result> 
<resData> 
<contact:infData 
xmlns:contact="urn:ietf:params:xml:ns:contact-1.0" 
xsi:schemaLocation="urn:ietf:params:xml:ns:contact-1.0 
contact-1.0.xsd"> 
<contact :id>sh8013</contact:id> 
<contact :roid>SH8013-REP</contact:roid> 
<contact:status s="linked"/> 
<contact:status s="clientDeleteProhibited"/> 
<contact:postallnfo type="int"> 
<contact:name>John Doe</contact:name> 
<contact:org>Example Inc.</contact:org> 
<contact:addr> 
<contact:street>123 Example Dr.</contact:street> 
<contact:street>Suite 100</contact:street> 
<contact:city>Dulles</contact:city> 
<contact:sp>VA</contact:sp> 
<contact :pc>20166-6503</contact :pc> 
<contact:cc>US</contact:cc> 
</contact:addr> 
</contact:postallnfo> 
<contact:voice x="1234">+1.7035555555</contact :voice> 
<contact:fax>+1.7035555556</contact:fax> 
<contact :email>jdoe@example.com</contact :email> 
<contact:clID>ClientY</contact:clID> 
<contact:crID>ClientX</contact:crID> 
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S <contact:ecrDate>1999-04-03T22:00:00.0Z</contact:crDate> 
S <contact:upID>ClientX</contact:upID> 

S <contact :upDate>1999-12-03T09:00:00.02</contact :upDate> 
S <contact:trDate>2000-04-08T09:00:00.0Z</contact:trDate> 
S <contact:authInfo> 

S <contact :pw>2fooBAR</contact :pw> 

S </contact:authInfo> 

S <contact:disclose flag="0"> 

S: <contact:voice/> 

S: <contact:email/> 

S </contact:disclose> 

S </contact:infData> 

S </resData> 

S <trID> 

S <c1TRID>ABC-12345</c1lTRID> 

S <svTRID>54322-XYZ</svTRID> 

S </trID> 

S </response> 

S:</epp> 


An EPP error response MUST be returned if an <info> command can not 
be processed for any reason. 


3.1.3. EPP <transfer> Query Command 


The EPP <transfer> command provides a query operation that allows a 
client to determine real-time status of pending and completed 
transfer requests. In addition to the standard EPP command elements, 
the <transfer> command MUST contain an "op" attribute with value 
"query", and a <contact:transfer> element that identifies the contact 
namespace and the location of the contact schema. The 
<contact:transfer> element MUST contain the following child elements: 


— A <contact:id> element that contains the server-unique identifier 
of the contact object to be queried. 


— An OPTIONAL <contact:authInfo> element that contains authorization 
information associated with the contact object. If this element 
is not provided or if the authorization information is invalid, 
server policy determines whether the command is rejected or the 
response information will be returned to the client. 


Example <transfer> query command: 


C:<?xml version="1.0" encoding="UTF-8" standalone="no"?> 
C:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0" 

Cs xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
Ce: xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 
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epp-1.0.xsd"> 
<command> 
<transfer op="query"> 
<contact:transfer 
xmlns:contact="urn:ietf:params:xmlins:contact-1.0" 
xsi:schemaLocation="urn:ietf:params:xml:ns:contact-1.0 
contact-1.0.xsd"> 
<contact :id>sh8013</contact:id> 
<contact :authInfo> 
<contact :pw>2fooBAR</contact : pw> 
</contact:authInfo> 
</contact:transfer> 
</transfer> 
<c1TRID>ABC-12345</c1TRID> 
</command> 


:</epp> 


when a <transfer> query command has been processed successfully, the 
EPP <resData> element MUST contain a child <contact:trnData> element 
that identifies the contact namespace and the location of the contact 
schema. The <contact:trnData> element contains the following child 
elements: 


A <contact:id> element that contains the server-unique identifier 
for the queried contact. 


A <contact:trStatus> element that contains the state of the most 
recent transfer request. 


A <contact:reID> element that contains the identifier of the 
client that requested the object transfer. 


A <contact:reDate> element that contains the date and time that 
the transfer was requested. 


A <contact:acID> element that contains the identifier of the 
client that SHOULD act upon the transfer request. 


A <contact:acDate> element that contains the date and time of a 
required or completed response. For a pending request, the value 
identifies the date and time by which a response is required 
before an automated response action SHOULD be taken by the server. 
For all other status types, the value identifies the date and time 
when the request was completed. 
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Example <transfer> query response: 


:<?xml version="1.0" encoding="UTF-8" standalone="no"?> 
:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 
epp-1.0.xsd"> 
<response> 
<result code="1000"> 
<msg>Command completed successfully</msg> 
</result> 
<resData> 
<contact:trnData 
xmlns:contact="urn:ietf:params:xml:ns:contact-1.0" 
xsi:schemaLocation="urn:ietf:params:xml:ns:contact-1.0 
contact-1.0.xsd"> 
<contact :id>sh8013</contact:id> 
<contact:trStatus>pending</contact:trStatus> 
<contact:reID>ClientX</contact:reID> 
<contact :reDate>2000-06-06T22:00:00.02</contact:reDate> 
<contact:acID>ClientY</contact:acID> 
<contact :acDate>2000-06-11T22:00:00.02</contact:acDate> 
</contact:trnData> 
</resData> 
<trID> 
<c1TRID>ABC-12345</c1TRID> 
<svTRID>54322-XYZ</svTRID> 
</trID> 
</response> 
:</epp> 


ANNNNNNNNNNNANNNANNNNNANNNANNNNN 


An EPP error response MUST be returned if a <transfer> query command 
can not be processed for any reason. 


3.2. EPP Transform Commands 


EPP provides four commands to transform contact object information: 
<create> to create an instance of a contact object, <delete> to 
delete an instance of a contact object, <transfer> to manage contact 
object sponsorship changes, and <update> to change information 
associated with a contact object. This document does not define a 
mapping for the EPP <renew> command. 


Transform commands are typically processed and completed in real 
time. Server operators MAY receive and process transform commands, 
but defer completing the requested action if human or third-party 
review is required before the requested action can be completed. In 
such situations the server MUST return a 1001 response code to the 


Hollenbeck Standards Track [Page 16] 


RFC 3733 EPP Contact Mapping March 2004 


client to note that the command has been received and processed, but 
the requested action is pending. The server MUST also manage the 
status of the object that is the subject of the command to reflect 
the initiation and completion of the requested action. Once the 
action has been completed, all clients involved in the transaction 
MUST be notified using a service message that the action has been 
completed and that the status of the object has changed. 


3.2.1. EPP <create> Command 


The EPP <create> command provides a transform operation that allows a 
client to create a contact object. In addition to the standard EPP 
command elements, the <create> command MUST contain a 
<contact:create> element that identifies the contact namespace and 
the location of the contact schema. The <contact:create> element 
contains the following child elements: 


- A <contact:id> element that contains the desired server-unique 
identifier for the contact to be created. 


- One or two <contact:postallnfo> elements that contain postal 
address information. Two elements are provided so that address 
information can be provided in both internationalized and 
localized forms; a "type" attribute is used to identify the two 
forms. If an internationalized form (type="int") is provided, 
element content MUST be represented in a subset of UTF-8 that can 
be represented in the 7-bit US-ASCII character set. Ifa 
localized form (type="loc") is provided, element content MAY be 
represented in unrestricted UTF-8. The <contact:postalInfo> 
element contains the following child elements: 


— A <contact:name> element that contains the name of the 
individual or role represented by the contact. 


— An OPTIONAL <contact:org> element that contains the name of the 
organization with which the contact is affiliated. 


- A <contact:addr> element that contains address information 
associated with the contact. A <contact:addr> element contains 


the following child elements: 


— One, two, or three OPTIONAL <contact:street> elements that 
contain the contact’s street address. 


— A <contact:city> element that contains the contact’s city. 


— An OPTIONAL <contact:sp> element that contains the contact’s 
state or province. 
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— An OPTIONAL <contact:pc> element that contains the contact’s 
postal code. 


- A <contact:cc> element that contains the contact’s country 
code. 


— An OPTIONAL <contact:voice> element that contains the contact’s 
voice telephone number. 


— An OPTIONAL <contact:fax> element that contains the contact’s 
facsimile telephone number. 


— A <contact:email> element that contains the contact’s email 
address. 


- A <contact:authInfo> element that contains authorization 
information to be associated with the contact object. This 
mapping includes a password-based authentication mechanism, but 
the schema allows new mechanisms to be defined in new schemas. 


— An OPTIONAL <contact:disclose> element that allows a client to 
identify elements that require exceptional server operator 
handling to allow or restrict disclosure to third parties. See 
section 2.9 for a description of the child elements contained 
within the <contact:disclose> element. 


Example <create> command: 


‘<?xml version="1.0" encoding="UTF-8" standalone="no"?> 
:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 
epp-1.0.xsd"> 
<command> 
<create> 


<contact:create 
xmlns:contact="urn:ietf:params:xml:ns:contact-1.0" 
xsi:schemaLocation="urn:ietf:params:xml:ns:contact-1.0 
contact-1.0.xsd"> 
<contact :id>sh8013</contact:id> 
<contact:postallnfo type="int"> 
<contact:name>John Doe</contact :name> 
<contact:org>Example Inc.</contact:org> 
<contact:addr> 
<contact:street>123 Example Dr.</contact:street> 
<contact:street>Suite 100</contact:street> 
<contact:city>Dulles</contact:city> 


C 
C 
C 
C 
C 
C 
C 
C 
C 
C: 
Cs 
C 
C 
© 
C 
C 
C 
& 
C 
C <contact :sp>VA</contact :sp> 


Hollenbeck Standards Track [Page 18] 


RFC 3733 EPP Contact Mapping March 2004 


<contact:pc>20166-6503</contact:pc> 
<contact :cc>US</contact :cc> 
</contact:addr> 
</contact:postalInfo> 
<contact:voice x="1234">+1.7035555555</contact:voice> 
<contact:fax>+1.7035555556</contact:fax> 
<contact :email>jdoe@example.com</contact:email> 
<contact:authInfo> 
<contact :pw>2fooBAR</contact : pw> 
</contact:authInfo> 
<contact:disclose flag="0"> 
<contact :voice/> 
<contact:email/> 
</contact:disclose> 
</contact:create> 
</create> 
<c1lTRID>ABC-12345</c1TRID> 
</command> 
:</epp> 


OO AsO. OO: Or OD OA OA 


When a <create> command has been processed successfully, the EPP 
<resData> element MUST contain a child <contact:creData> element that 
identifies the contact namespace and the location of the contact 
schema. The <contact:creData> element contains the following child 
elements: 


— A <contact:id> element that contains the server-unique identifier 
for the created contact. 


- A <contact:crDate> element that contains the date and time of 
contact object creation. 


Example <create> response: 


<contact:creData 
xmlns:contact="urn:ietf:params:xml:ns:contact-1.0" 
xsi:schemaLocation="urn:ietf:params:xml:ns:contact-1.0 
contact-1.0.xsd"> 


S:<?xml version="1.0" encoding="UTF-8" standalone="no"?> 
S:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0" 

Ss xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
S: xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 
Ss epp-1.0.xsd"> 

S: <response> 

S: <result code="1000"> 

S: <msg>Command completed successfully</msg> 

S: </result> 

S: <resData> 

S: 

S: 

S: 

S: 
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S: <contact:id>sh8013</contact:id> 

Sz <contact:crDate>1999-04-03T22:00:00.0Z</contact:crDate> 
S: </contact:creData> 

S: </resData> 

S: <trID> 

S: <c1lTRID>ABC-12345</c1TRID> 

S: <svTRID>54321-XYZ</svTRID> 

S: </trID> 

S: </response> 

S:</epp> 


An EPP error response MUST be returned if a <create> command can not 
be processed for any reason. 


3.2.2. EPP <delete> Command 


The EPP <delete> command provides a transform operation that allows a 
client to delete a contact object. In addition to the standard EPP 
command elements, the <delete> command MUST contain a 
<contact:delete> element that identifies the contact namespace and 
the location of the contact schema. The <contact:delete> element 
MUST contain the following child element: 


— A <contact:id> element that contains the server-unique identifier 
of the contact object to be deleted. 


A contact object SHOULD NOT be deleted if it is associated with 
other known objects. An associated contact SHOULD NOT be deleted 
until associations with other known objects have been broken. A 
server SHOULD notify clients of object relationships when a 
<delete> command is attempted and fails due to existing object 
relationships. 


Example <delete> command: 


C:<?xml version="1.0" encoding="UTF-8" standalone="no"?> 
C:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0" 

€ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
C xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 

C epp-1.0.xsd"> 

C <command> 

Cs <delete> 

Ct <contact:delete 

€ xmlns:contact="urn:ietf:params:xml:ns:contact-1.0" 
C xsi:schemaLocation="urn:ietf:params:xml:ns:contact-1.0 
& contact-1.0.xsd"> 

Cc <contact:id>sh8013</contact:id> 

€ </contact:delete> 
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© </delete> 

C <CITRID>ABC-12345</clTRID> 
C: </command> 

C:</epp> 


When a <delete> command has been processed successfully, a server 
MUST respond with an EPP response with no <resData> element. 


Example <delete> response: 


S:<?xml version="1.0" encoding="UTF-8" standalone="no"?> 
S:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0" 

Ss xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
S: xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 
Ss: epp-1.0.xsd"> 

S: <response> 

S: <result code="1000"> 

S: <msg>Command completed successfully</msg> 

S: </result> 

S: <trID> 

S: <c1TRID>ABC-12345</c1TRID> 

Se <svTRID>54321-XYZ</svTRID> 

Si </trID> 

S: </response> 

S:</epp> 


An EPP error response MUST be returned if a <delete> command can not 
be processed for any reason. 


3.2.3. EPP <renew> Command 


Renewal semantics do not apply to contact objects, so there is no 
mapping defined for the EPP <renew> command. 


3.2.4. EPP <transfer> Command 


The EPP <transfer> command provides a transform operation that allows 
a client to manage requests to transfer the sponsorship of a contact 
object. In addition to the standard EPP command elements, the 
<transfer> command MUST contain a <contact:transfer> element that 
identifies the contact namespace and the location of the contact 
schema. The <contact:transfer> element contains the following child 
elements: 


- A <contact:id> element that contains the server-unique identifier 


of the contact object for which a transfer request is to be 
created, approved, rejected, or cancelled. 
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- A <contact:authInfo> element that contains authorization 
information associated with the contact object. 


Every EPP <transfer> command MUST contain an "op" attribute that 
identifies the transfer operation to be performed as defined in 
[RFC3730]. 


Example <transfer> request command: 


:<?xml version="1.0" encoding="UTF-8" standalone="no"?> 
:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 
epp-1.0.xsd"> 
<command> 
<transfer op="request"> 
<contact:transfer 
xmlns:contact="urn:ietf:params:xmlins:contact-1.0" 
xsi:schemaLocation="urn:ietf:params:xml:ns:contact-1.0 
contact-1.0.xsd"> 
<contact :id>sh8013</contact:id> 
<contact :authInfo> 
<contact :pw>2fooBAR</contact : pw> 
</contact:authInfo> 
</contact:transfer> 
</transfer> 
<c1TRID>ABC-12345</c1TRID> 
</command> 
:</epp> 


MOM: I OOAD ODO OOM 


When a <transfer> command has been processed successfully, the EPP 
<resData> element MUST contain a child <contact:trnData> element that 
identifies the contact namespace and the location of the contact 
schema. The <contact:trnData> element contains the same child 
elements defined for a transfer query response. 


Example <transfer> response: 


S:<?xml version="1.0" encoding="UTF-8" standalone="no"?> 
S:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0" 

S: xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
S: xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 

S: epp-1.0.xsd"> 

S: <response> 

S: <result code="1000"> 

S: <msg>Command completed successfully</msg> 

Si </result> 

S: <resData> 
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<contact:trnData 
xmlns:contact="urn:ietf:params:xml:ins:contact-1.0" 
xsi:schemaLocation="urn:ietf:params:xml:ns:contact-1.0 
contact-1.0.xsd"> 
<contact :id>sh8013</contact:id> 
<contact:trStatus>pending</contact:trStatus> 
<contact:reID>ClientX</contact:reID> 
<contact :reDate>2000-06-08T22:00:00.02</contact:reDate> 
<contact :acID>ClientY</contact:aclID> 
<contact :acDate>2000-06-13T22:00:00.02</contact:acDate> 
</contact:trnData> 
</resData> 
<trID> 
<c1lTRID>ABC-12345</c1TRID> 
<svTRID>54322-XYZ</svTRID> 
</trID> 
</response> 
:</epp> 


N NN NN NN nn nn nn 


An EPP error response MUST be returned if a <transfer> command can 
not be processed for any reason. 


3.2.5. EPP <update> Command 


The EPP <update> command provides a transform operation that allows a 
client to modify the attributes of a contact object. In addition to 
the standard EPP command elements, the <update> command MUST contain 
a <contact:update> element that identifies the contact namespace and 
the location of the contact schema. The <contact:update> element 
contains the following child elements: 


- A <contact:id> element that contains the server-unique identifier 
of the contact object to be updated. 


- An OPTIONAL <contact:add> element that contains attribute values 
to be added to the object. 


- An OPTIONAL <contact:rem> element that contains attribute values 
to be removed from the object. 


- An OPTIONAL <contact:chg> element that contains object attribute 
values to be changed. 


At least one <contact:add>, <contact:rem>, or <contact:chg> element 


MUST be provided. The <contact:add> and <contact:rem> elements 
contain the following child elements: 
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— One or more <contact:status> elements that contain status values 
to be associated with or removed from the object. When specifying 
a value to be removed, only the attribute value is significant; 
element text is not required to match a value for removal. 


A <contact:chg> element contains the following OPTIONAL child 
elements. At least one child element MUST be present: 


- One or two <contact:postallnfo> elements that contain postal 
address information. Two elements are provided so that address 
information can be provided in both internationalized and 
localized forms; a "type" attribute is used to identify the two 
forms. If an internationalized form (type="int") is provided, 
element content MUST be represented in a subset of UTF-8 that can 
be represented in the 7-bit US-ASCII character set. Ifa 
localized form (type="loc") is provided, element content MAY be 
represented in unrestricted UTF-8. The <contact:postalInfo> 
element contains the following OPTIONAL child elements: 


— A <contact:name> element that contains the name of the 
individual or role represented by the contact. 


- A <contact:org> element that contains the name of the 
organization with which the contact is affiliated. 


- A <contact:addr> element that contains address information 
associated with the contact. A <contact:addr> element contains 


the following child elements: 


- One, two, or three OPTIONAL <contact:street> elements that 
contain the contact’s street address. 


— A <contact:city> element that contains the contact’s city. 


— An OPTIONAL <contact:sp> element that contains the contact’s 
state or province. 


— An OPTIONAL <contact:pc> element that contains the contact’s 
postal code. 


- A <contact:cc> element that contains the contact’s country 
code. 


- A <contact:voice> element that contains the contact’s voice 
telephone number. 
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A <contact:fax> element that contains the contact’s facsimile 
telephone number. 


A <contact:email> element that contains the contact’s email 
address. 


A <contact:authInfo> element that contains authorization 
information associated with the contact object. This mapping 
includes a password-based authentication mechanism, but the schema 
allows new mechanisms to be defined in new schemas. 


A <contact:disclose> element that allows a client to identify 
elements that require exceptional server operator handling to 
allow or restrict disclosure to third parties. See section 2.9. 
for a description of the child elements contained within the 
<contact:disclose> element. 


Example <update> command: 


C:<?xml version="1.0" encoding="UTF-8" standalone="no"?> 
C:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0" 


OQ: ACO OOC OO. ON Or ACO, OO QAO: AO Ala 


xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 
epp-1.0.xsd"> 
<command> 
<update> 
<contact :update 
xmlns:contact="urn:ietf:params:xml:ns:contact-1.0" 
xsi:schemaLocation="urn:ietf:params:xml:ns:contact-1.0 
contact-1.0.xsd"> 
<contact :id>sh8013</contact:id> 
<contact :add> 
<contact:status s="clientDeleteProhibited"/> 
</contact:add> 
<contact:chg> 
<contact:postallnfo type="int"> 
<contact:org/> 
<contact:addr> 
<contact:street>124 Example Dr.</contact:street> 
<contact:street>Suite 200</contact:street> 
<contact:city>Dulles</contact:city> 
<contact :sp>VA</contact:sp> 
<contact :pc>20166-6503</contact :pc> 
<contact:cc>US</contact:cc> 
</contact:addr> 
</contact:postalInfo> 
<contact :voice>+1.7034444444</contact:voice> 
<contact:fax/> 
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<contact:authInfo> 
<contact :pw>2fooBAR</contact :pw> 
</contact:authInfo> 
<contact:disclose flag="1"> 
<contact :voice/> 
<contact:email/> 
</contact:disclose> 
</contact:chg> 
</contact :update> 
</update> 
<c1TRID>ABC-12345</c1TRID> 
</command> 
:</epp> 


OQ. Oi: OO. OO: OOO: AQ 


When an <update> command has been processed successfully, a server 
MUST respond with an EPP response with no <resData> element. 


Example <update> response: 


S:<?xml version="1.0" encoding="UTF-8" standalone="no"?> 
S:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0" 

Ss xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
S: xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 
S3 epp-1.0.xsd"> 

S: <response> 

S3 <result code="1000"> 

Si <msg>Command completed successfully</msg> 

Si </result> 

S: <trID> 

S: <c1TRID>ABC-12345</c1TRID> 

St <svTRID>54321-XYZ</svTRID> 

S: </trID> 

S: </response> 

S:</epp> 


An EPP error response MUST be returned if an <update> command can not 
be processed for any reason. 


3.2.6. Offline Review of Requested Actions 


Commands are processed by a server in the order they are received 
from a client. Though an immediate response confirming receipt and 
processing of the command is produced by the server, a server 
operator MAY perform an offline review of requested transform 
commands before completing the requested action. In such situations, 
the response from the server MUST clearly note that the transform 
command has been received and processed, but the requested action is 
pending. The status of the corresponding object MUST clearly reflect 
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processing of the pending action. The server MUST notify the client 
when offline processing of the action has been completed. 


Examples describing a <create> command that requires offline review 
are included here. Note the result code and message returned in 
response to the <create> command. 


:<?xml version="1.0" encoding="UTF-8" standalone="no"?> 
:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 
epp-1.0.xsd"> 
<response> 
<result code="1001"> 
<msg>Command completed successfully; action pending</msg> 
</result> 
<resData> 
<contact:creData 
xmlns:contact="urn:ietf:params:xml:ns:contact-1.0" 
xsi:schemaLocation="urn:ietf:params:xml:ns:contact-1.0 
contact-1.0.xsd"> 
<contact :id>sh8013</contact:id> 
<contact :crDate>1999-04-03T22:00:00.02</contact:crDate> 
</contact:creData> 
</resData> 
<trID> 
<c1TRID>ABC-12345</c1TRID> 
<svTRID>54321-XYZ</svTRID> 
</trID> 
</response> 
:</epp> 


ANNNNNNNNNNANNANNNANNNANNNNN 


The status of the contact object after returning this response MUST 
include "pendingCreate". The server operator reviews the request 
offline, and informs the client of the outcome of the review by 
queuing a service message for retrieval via the <poll> command. 


The service message MUST contain text in the <response>, <msgQ>, 
<msg> element that describes the notification. In addition, the EPP 
<resData> element MUST contain a child <contact:panData> element that 
identifies the contact namespace and the location of the contact 
schema. The <contact:panData> element contains the following child 
elements: 


— A <contact:id> element that contains the server-unique identifier 
of the contact object. The <contact:id> element contains a 
REQUIRED "paResult" attribute. A positive boolean value indicates 
that the request has been approved and completed. A negative 
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boolean value indicates that the request has been denied and the 
requested action has not been taken. 


— A <contact:paTRID> element that contains the client transaction 
identifier and server transaction identifier returned with the 
original response to process the command. The client transaction 
identifier is OPTIONAL and will only be returned if the client 
provided an identifier with the original <create> command. 


- A <contact:paDate> element that contains the date and time 
describing when review of the requested action was completed. 


Example "review completed" service message: 


:<?xml version="1.0" encoding="UTF-8" standalone="no"?> 
:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 
epp-1.0.xsd"> 
<response> 
<result code="1301"> 
<msg>Command completed successfully; ack to dequeue</msg> 
</result> 
<msgQ count="5" id="12345"> 
<qDate>1999-04-04T22:01:00.02</qDate> 
<msg>Pending action completed successfully.</msg> 
</msgQ> 
<resData> 
<contact:panData 
xmlns:contact="urn:ietf:params:xml:ns:contact-1.0" 
xsi:schemaLocation="urn:ietf:params:xml:ns:contact-1.0 
contact-1.0.xsd"> 
<contact:id paResult="1">sh8013</contact:id> 
<contact :paTRID> 
<c1TRID>ABC-12345</c1TRID> 
<svTRID>54321-XYZ</svTRID> 
</contact:paTRID> 
<contact :paDate>1999-04-04T22:00:00.02</contact :paDate> 
</contact:panData> 
</resData> 
<trID> 
<c1TRID>BCD-23456</c1TRID> 
<svTRID>65432-WXY</svTRID> 
</trID> 
</response> 
:</epp> 


ANNNNNNNNNNNNANNNNANANNANNANNNANNNNNNN 
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4. Formal Syntax 


An EPP object mapping is specified in XML Schema notation. The 
formal syntax presented here is a complete schema representation of 
the object mapping suitable for automated validation of EPP XML 
instances. The BEGIN and END tags are not part of the schema; they 
are used to note the beginning and ending of the schema for URI 
registration purposes. 


BEGIN 
<?xml version="1.0" encoding="UTF-8"?> 


<schema targetNamespace="urn:ietf:params:xml:ns:contact-1.0" 
xmlns:contact="urn:ietf:params:xml:ns:contact-1.0" 
xmlns:epp="urn:ietf:params:xml:ns:epp-1.0" 
xmlns:eppcom="urn:ietf:params:xml:ns:eppcom-1.0" 
xmlns="http://www.w3.org/2001/XMLSchema" 
elementFormDefault="qualified"> 


<i== 
Import common element types. 
--> 
<import namespace="urn:ietf:params:xml:ns:eppcom-1.0" 
schemaLocation="eppcom-1.0.xsd"/> 
<import namespace="urn:ietf:params:xml:ns:epp-1.0" 
schemaLocation="epp-1.0.xsd"/> 


<annotation> 
<documentation> 
Extensible Provisioning Protocol v1.0 
contact provisioning schema. 
</documentation> 
</annotation> 


<!-- 

Child elements found in EPP commands. 

--> 
<element name="check" type="contact :mIDType"/> 
<element name="create" type="contact:createType"/> 
<element name="delete" type="contact:sIDType"/> 
<element name="info" type="contact:authIDType"/> 
<element name="transfer" type="contact:authIDType"/> 
<element name="update" type="contact:updateType"/> 


ir 
Utility types. 
--> 
<simpleType name="ccType"> 
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<restriction base="token"> 
<length value="2"/> 
</restriction> 
</simpleType> 
<complexType name="e164Type"> 


<simpleCont 
<extensio 
<attrib 
</extensi 
</simpleCon 
</complexType 


<simpleType n 


ent> 

n base="contact:el64StringIype"> 
ute name="x" type="token"/> 

on> 

tent> 

> 


<restrictio 


<pattern value="(\+[0-9]{1,3}\. [0-9] {1,14}) ?"/> 


<maxLengt 
</restricti 
</simpleType> 


<simpleType n 
<restrictio 
<maxLengt 
</restricti 
</simpleType> 


<simpleType n 
<restricti 


ame="el64StringType"> 
n base="token"> 


h value="17"/> 
on> 


ame="pcType"> 


n base="token"> 
h value="16"/> 
on> 


ame="postalLineType"> 
on base="normalizedString"> 


<minLength value="1"/> 
<maxLength value="255"/> 


</restrict 
</simpleType> 


<simpleType n 


ion> 


ame="optPostalLineType"> 


March 2004 


<restriction base="normalizedString"> 
<maxLength value="255"/> 
</restriction> 
</simpleType> 
<!-- 
Child elements of the <create> command. 
--> 
<complexType name="createType"> 
<sequence> 
<element name="id" type="eppcom:clIDType"/> 
<element name="postallnfo" type="contact :postallnfoType" 
maxOccurs="2"/> 
<element name="voice" type="contact:el64Type" 
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minOccurs="0"/> 
<element name="fax" type="contact:el64Type" 
minOccurs="0"/> 
<element name="email" type="eppcom:minTokenType"/> 
<element name="authInfo" type="contact:authInfoType"/> 
<element name="disclose" type="contact:discloseType" 
minOccurs="0"/> 
</sequence> 
</complexType> 


<complexType name="postallnfoType"> 
<sequence> 
<element name="name" type="contact:postalLineType"/> 
<element name="org" type="contact:optPostalLineType" 
minOccurs="0"/> 
<element name="addr" type="contact:addrType"/> 
</sequence> 
<attribute name="type" type="contact:postallnfoEnumType" 
use="required"/> 
</complexType> 


<simpleType name="postallnfoEnumType"> 
<restriction base="token"> 
<enumeration value="loc"/> 
<enumeration value="int"/> 
</restriction> 
</simpleType> 


<complexType name="addrType"> 
<sequence> 
<element name="street" type="contact:optPostalLineType" 
minOccurs="0" maxOccurs="3"/> 
<element name="city" type="contact:postalLineType"/> 
<element name="sp" type="contact:optPostalLineType" 
minOccurs="0"/> 
<element name="pc" type="contact:pcType" 
minOccurs="0"/> 
<element name="cc" type="contact:ccType"/> 
</sequence> 
</complexType> 


<complexType name="authInfoType"> 
<choice> 
<element name="pw" type="eppcom: pwAuthInfoType"/> 
<element name="ext" type="eppcom:extAuthInfoType"/> 
</choice> 
</complexType> 
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<complexType name="discloseType"> 
<sequence> 
<element name="name" type="contact:intLocType" 
minOccurs="0" maxOccurs="2"/> 
<element name="org" type="contact:intLocType" 
minOccurs="0" maxOccurs="2"/> 
<element name="addr" type="contact:intLocType" 
minOccurs="0" maxOccurs="2"/> 
<element name="voice" minOccurs="0"/> 
<element name="fax" minOccurs="0"/> 
<element name="email" minOccurs="0"/> 
</sequence> 
<attribute name="flag" type="boolean" use="required"/> 
</complexType> 


<complexType name="intLocType"> 
<attribute name="type" type="contact:postallnfoEnumType" 
use="required"/> 


</complexType> 
iz 
Child element of commands that require only an identifier. 
--> 
<complexType name="sIDType"> 
<sequence> 
<element name="id" type="eppcom:clIDType"/> 
</sequence> 
</complexType> 
<!-- 
Child element of commands that accept multiple identifiers. 
--> 
<complexType name="mIDType"> 
<sequence> 
<element name="id" type="eppcom:clIDType" 
maxOccurs="unbounded"/> 
</sequence> 
</complexType> 
<!-- 
Child elements of the <info> and <transfer> commands. 
--> 
<complexType name="authIDType"> 
<sequence> 


<element name="id" type="eppcom:clIDType"/> 
<element name="authInfo" type="contact:authInfoType" 
minOccurs="0"/> 

</sequence> 
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</complexType> 
<!-- 
Child elements of the <update> command. 
--> 
<complexType name="updateType"> 
<sequence> 
<element name="id" type="eppcom:clIDType"/> 
<element name="add" type="contact :addRemType" 
minOccurs="0"/> 
<element name="rem" type="contact :addRemType" 
minOccurs="0"/> 
<element name="chg" type="contact:chgType" 
minOccurs="0"/> 
</sequence> 
</complexType> 
<!-- 
Data elements that can be added or removed. 
--> 
<complexType name="addRemType"> 
<sequence> 
<element name="status" type="contact :statusType" 
maxOccurs="7"/> 
</sequence> 
</complexType> 
<!-- 
Data elements that can be changed. 
--> 
<complexType name="chgType"> 
<sequence> 


<element name="postallnfo" type="contact:chgPostallnfoType" 
minOccurs="0" maxOccurs="2"/> 
<element name="voice" type="contact :el164Type" 
minOccurs="0"/> 
<element name="fax" type="contact :el164Type" 
minOccurs="0"/> 
<element name="email" type="eppcom:minTokenType" 
minOccurs="0"/> 
<element name="authInfo" type="contact:authInfoType" 
minOccurs="0"/> 
<element name="disclose" type="contact:discloseType" 
minOccurs="0"/> 
</sequence> 
</complexType> 


<complexType name="chgPostallnfoType"> 
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<sequence> 
<element name="name" type="contact:postalLineType" 
minOccurs="0"/> 
<element name="org" type="contact:optPostalLineType" 
minOccurs="0"/> 
<element name="addr" type="contact:addrType" 
minOccurs="0"/> 
</sequence> 
<attribute name="type" type="contact:postallnfoEnumType" 
use="required"/> 


</complexType> 
<!-- 
Child response elements. 
--> 
<element name="chkData" type="contact:chkDataType"/> 
<element name="creData" type="contact:creDataType"/> 
<element name="infData" type="contact:infDataType"/> 
<element name="panData" type="contact:panDataType"/> 
<element name="trnData" type="contact:trnDataType"/> 
SS 
<check> response elements. 
--> 
<complexType name="chkDataType"> 
<sequence> 
<element name="cd" type="contact:checkType" 
maxOccurs="unbounded"/> 
</sequence> 
</complexType> 


<complexType name="checkType"> 
<sequence> 
<element name="id" type="contact:checkIDType"/> 
<element name="reason" type="eppcom:reasonType" 
minOccurs="0"/> 
</sequence> 
</complexType> 


<complexType name="checkIDType"> 
<simpleContent> 
<extension base="eppcom:clIDType"> 
<attribute name="avail" type="boolean" 
use="required"/> 
</extension> 
</simpleContent> 
</complexType> 
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<create> response elements. 


--> 


<complexType name="creDataType"> 


<sequence> 


<element name="id" type="eppcom:clIDType"/> 
<element name="crDate" type="dateTime"/> 


</sequence> 


</complexType> 


sies 


<info> response elements. 


--> 


<complexType name="infDataType"> 


<sequence> 


<element name="id" type="eppcom:clIDType"/> 

<element name="roid" type="eppcom: roidType"/> 
<element name="status" type="contact:statusType" 
maxOccurs="7"/> 

<element name="postallnfo" type="contact :postallnfoType" 
maxOccurs="2"/> 

<element name="voice" type="contact:el64Type" 
minOccurs="0"/> 

<element name="fax" type="contact:el64Type" 
minOccurs="0"/> 

<element name="email" type="eppcom:minTokenType"/> 
<element name="ClID" type="eppcom:clIDIype"/> 
<element name="crID" type="eppcom:clIDIype"/> 
<element name="crDate" type="dateTime"/> 

<element name="upID" type="eppcom:clIDIype" 
minOccurs="0"/> 

<element name="upDate" type="dateTime" 
minOccurs="0"/> 

<element name="trDate" type="dateTime" 
minOccurs="0"/> 

<element name="authInfo" type="contact:authlInfoType" 
minOccurs="0"/> 

<element name="disclose" type="contact:discloseType" 
minOccurs="0"/> 


</sequence> 


</complexType> 


Sir 


2004 


Status is a combination of attributes and an optional human-readable 
message that may be expressed in languages other than English. 


--> 


<complexType name="statusType"> 


<simpleContent> 
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<extension base="normalizedString"> 
<attribute name="s" type="contact:statusValueType" 
use="required"/> 
<attribute name="lang" type="language" 


default="en"/> 


</extension> 


</simpleContent> 
</complexType> 


<simpleType name="statusValueType"> 
<restriction base="token"> 


<enumeration value="clientDeleteProhibited"/> 
<enumeration value="clientTransferProhibited"/> 
<enumeration value="clientUpdateProhibited"/> 
<enumeration value="linked"/> 
<enumeration value="ok"/> 
<enumeration value="pendingCreate"/> 
<enumeration value="pendingDelete"/> 
<enumeration value="pendingTransfer"/> 
<enumeration value="pendingUpdate"/> 
<enumeration value="serverDeleteProhibited"/> 
<enumeration value="serverTransferProhibited"/> 
<enumeration value="serverUpdateProhibited"/> 
</restriction> 
</simpleType> 
Glas 
Pending action notification response elements. 
--> 
<complexType name="panDataType"> 
<sequence> 
<element name="id" type="contact:paCLIDType"/> 
<element name="paTRID" type="epp:trIDType"/> 
<element name="paDate" type="dateTime"/> 
</sequence> 
</complexType> 
<complexType name="paCLIDType"> 
<simpleContent> 
<extension base="eppcom:clIDType"> 
<attribute name="paResult" type="boolean" 
use="required"/> 
</extension> 
</simpleContent> 
</complexType> 
<!-- 


<transfer> response elements. 
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--> 
<complexType name="trnDataType"> 
<sequence> 
<element name="id" type="eppcom:clIDType"/> 
<element name="trStatus" type="eppcom:trStatusType"/> 
<element name="reID" type="eppcom:clIDIype"/> 
<element name="reDate" type="dateTime"/> 
<element name="acID" type="eppcom:clIDIype"/> 
<element name="acDate" type="dateTime"/> 
</sequence> 
</complexType> 
<= 
End of schema. 
--> 
</schema> 
END 
5. Internationalization Considerations 


EPP is represented in XML, which provides native support for encoding 
information using the Unicode character set and its more compact 
representations, including UTF-8. Conformant XML processors 
recognize both UTF-8 and UTF-16 [RFC2781]. Though XML includes 
provisions to identify and use other character encodings through use 
of an "encoding" attribute in an <?xml?> declaration, use of UTF-8 is 
RECOMMENDED in environments where parser encoding support 
incompatibility exists. 


All date-time values presented via EPP MUST be expressed in Universal 
Coordinated Time using the Gregorian calendar. The XML Schema allows 
use of time zone identifiers to indicate offsets from the zero 
meridian, but this option MUST NOT be used with EPP. The extended 
date-time form using upper case "T" and "Z" characters defined in 
[RFC3339] MUST be used to represent date-time values as the XML 
Schema does not support truncated date-time forms or lower case "T" 
and "2" characters. 


Humans, organizations, and other entities often need to represent 
social information in both a commonly understood character set and a 
locally optimized character set. This specification provides 
features allowing representation of social information in both a 
subset of UTF-8 for broad readability and unrestricted UTF-8 for 
local optimization. 
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6. 


IANA Considerations 


This document uses URNs to describe XML namespaces and XML schemas 
conforming to a registry mechanism described in [RFC3688]. Two URI 
assignments have been registered by the IANA. 


Registration request for the contact namespace: 
URI: urn:ietf:params:xml:ns:contact-1.0 


Registrant Contact: See the "Author’s Address" section of this 
document. 


XML: None. Namespace URIs do not represent an XML specification. 
Registration request for the contact XML schema: 
URI: urn:ietf:params:xml:schema:contact-1.0 


Registrant Contact: See the "Author’s Address" section of this 
document. 


XML: See the "Formal Syntax" section of this document. 
Security Considerations 


Authorization information as described in section 2.8. is REQUIRED to 
create a contact object. This information is used in some query and 
transfer operations as an additional means of determining client 
authorization to perform the command. Failure to protect 
authorization information from inadvertent disclosure can result in 
unauthorized transfer operations and unauthorized information 
release. Both client and server MUST ensure that authorization 
information is stored and exchanged with high-grade encryption 
mechanisms to provide privacy services. 


The object mapping described in this document does not provide any 
other security services or introduce any additional considerations 
beyond those described by [RFC3730] and protocol layers used by EPP. 
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